MCP 문서 관리

메뉴

문서 정보

최종 수정일:
2025-05-12 20:15

Sentry MCP 서버

Sentry

MCP-server-sentry는 Sentry.io에서 이슈를 검색하고 분석하기 위한 Model Context Protocol 서버입니다. 이 서버는 Sentry 계정에서 오류 보고서, 스택 트레이스 및 기타 디버깅 정보를 검사하는 도구를 제공합니다.

특징

  • Sentry 이슈 ID 또는 URL로 이슈 정보 검색
  • 이슈 세부 정보 분석 (제목, 상태, 수준, 발생 시간 등)
  • 스택 트레이스 및 오류 정보 검색
  • 대화 컨텍스트용 포맷팅된 이슈 세부 정보 제공

API

도구

get_sentry_issue

ID 또는 URL로 Sentry 이슈를 검색하고 분석합니다.

  • 입력:
  • issue_id_or_url (문자열): 분석할 Sentry 이슈 ID 또는 URL

  • 반환: 다음을 포함한 이슈 세부 정보:

  • 제목
  • 이슈 ID
  • 상태
  • 수준
  • 처음 발견된 타임스탬프
  • 마지막으로 발견된 타임스탬프
  • 이벤트 수
  • 전체 스택 트레이스

프롬프트

sentry-issue

Sentry에서 이슈 세부 정보를 검색합니다.

  • 입력:
  • issue_id_or_url (문자열): Sentry 이슈 ID 또는 URL

  • 반환: 대화 컨텍스트로 포맷팅된 이슈 세부 정보

사용 방법

설치

uv 사용(권장)

uv를 사용할 때는 특별한 설치가 필요하지 않습니다. uvx를 사용하여 mcp-server-sentry를 직접 실행합니다.

PIP 사용

또는 pip를 통해 mcp-server-sentry를 설치할 수 있습니다:

pip install mcp-server-sentry

설치 후 스크립트로 실행할 수 있습니다:

python -m mcp_server_sentry

구성

Claude Desktop에서 사용

claude_desktop_config.json에 다음을 추가하세요:

uvx 사용
"mcpServers": {
  "sentry": {
    "command": "uvx",
    "args": ["mcp-server-sentry", "--auth-token", "YOUR_SENTRY_TOKEN"]
  }
}
Docker 사용
"mcpServers": {
  "sentry": {
    "command": "docker",
    "args": ["run", "-i", "--rm", "mcp/sentry", "--auth-token", "YOUR_SENTRY_TOKEN"]
  }
}
pip 설치 사용
"mcpServers": {
  "sentry": {
    "command": "python",
    "args": ["-m", "mcp_server_sentry", "--auth-token", "YOUR_SENTRY_TOKEN"]
  }
}

VS Code에서 사용

VS Code User Settings(JSON) 파일에 다음 JSON 블록을 추가하세요. Ctrl + Shift + P를 누르고 Preferences: Open Settings (JSON)를 입력하여 이 작업을 수행할 수 있습니다.

선택적으로 작업 공간의 .vscode/mcp.json 파일에 추가할 수 있습니다. 이렇게 하면 다른 사람과 구성을 공유할 수 있습니다.

.vscode/mcp.json 파일을 사용할 때는 mcp 키가 필요합니다.

uvx 사용
{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "auth_token",
        "description": "Sentry Auth Token",
        "password": true
      }
    ],
    "servers": {
      "sentry": {
        "command": "uvx",
        "args": ["mcp-server-sentry"],
        "env": {
          "SENTRY_AUTH_TOKEN": "${input:auth_token}"
        }
      }
    }
  }
}
Docker 사용
{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "auth_token",
        "description": "Sentry Auth Token",
        "password": true
      }
    ],
    "servers": {
      "sentry": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "mcp/sentry"],
        "env": {
          "SENTRY_AUTH_TOKEN": "${input:auth_token}"
        }
      }
    }
  }
}

Zed에서 사용

Zed settings.json에 추가하세요:

uvx 사용
"context_servers": [
  "mcp-server-sentry": {
    "command": {
      "path": "uvx",
      "args": ["mcp-server-sentry", "--auth-token", "YOUR_SENTRY_TOKEN"]
    }
  }
],
pip 설치 사용
"context_servers": {
  "mcp-server-sentry": {
    "command": {
      "path": "python",
      "args": ["-m", "mcp_server_sentry", "--auth-token", "YOUR_SENTRY_TOKEN"]
    }
  }
},

디버깅

MCP 인스펙터를 사용하여 서버를 디버깅할 수 있습니다. uvx 설치의 경우:

npx @modelcontextprotocol/inspector uvx mcp-server-sentry --auth-token YOUR_SENTRY_TOKEN

또는 특정 디렉토리에 패키지를 설치했거나 개발 중인 경우:

cd path/to/servers/src/sentry
npx @modelcontextprotocol/inspector uv run mcp-server-sentry --auth-token YOUR_SENTRY_TOKEN

빌드

Docker 빌드:

docker build -t mcp/sentry -f src/sentry/Dockerfile .

라이선스

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 이는 MIT 라이선스의 약관 및 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있음을 의미합니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.

연결된 구성 요소